home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / emulatrs / cpm.arc / CPM_HELP.TXT < prev    next >
Encoding:
Text File  |  1987-01-04  |  6.9 KB  |  131 lines
  1.  
  2.  
  3.                 SETTING UP AND USING THE ATARI CP/M EMULATOR
  4.                 --------------------------------------------
  5.  
  6. (Copyright 1986 Robert J. Retelle  Permission to copy granted, as long as this
  7. notice remains intact.  Originally written for members of the GEnie ST Roundtable.)
  8.  
  9.  
  10. Before you can use the Atari CP/M 2.2 Emulator system, you'll have to do a
  11. little preparation of the disks you'll be using, since CP/M uses a different
  12. disk format from the normal TOS formatted disks.
  13.  
  14. First of all, FORMAT several SINGLE-SIDED disks (CP/M only recognizes SS disks!)
  15. Then UnARC the CPM.ARC file using the normal ARC.TTP program. This will create
  16. a disk filled with various files, most of which are CP/M files which will NOT
  17. run for now.
  18.  
  19. Click on MAKE_CPM.TOS and follow the prompts when it says to insert one of your
  20. blank, formatted disks. When the program is finished, you will have a CP/M
  21. formatted disk with 2 important CP/M utilities on it.
  22.  
  23. It is important to understand that there are 2 *different* environments at work
  24. here. When you want to use the CP/M Emulator, you will need at least 2 disks,
  25. one normal ST disk with the program CPMZ80.TOS on it (the actual CP/M Emulator
  26. which runs in your ST), and one or more CP/M formatted disks.
  27.  
  28. When you want to run CP/M, you FIRST put the ST disk in, and click on CPMZ80.TOS.
  29. Then when promped, remove the ST disk and put in a CP/M disk. From then on,
  30. you are effectively using a Z80 CPU machine, with 64K of memory. You CANNOT
  31. use the GEM Desktop for directories or formatting new disks once you are in
  32. CP/M. If you need to format another disk, you must type EXIT, and go back
  33. to the normal ST environment.
  34.  
  35. When first setting up your CP/M Emulator system, there's some busywork you
  36. have to go through to transfer the CP/M utilities and programs that you UnARCed
  37. along with the main CPMZ80.TOS program.
  38.  
  39. While you're still in GEM, open a directory window on the disk containing
  40. all the files that came out of the CPM.ARC file. WRITE DOWN the filenames
  41. of all that have a .COM extender. These are the ones you'll want to transfer
  42. to a CP/M disk, but once you're in CP/M, you CANNOT look at a TOS directory.
  43.  
  44. Then click on CPMZ80.TOS to go into CP/M. When prompted, insert the disk you
  45. created with MAKE_CPM.TOS. You should see the CP/M prompt, A:
  46.  
  47. (If you have 2 disk drives, this will go much faster. If you have only one
  48. disk drive, condolences to your patience and sanity.)
  49.  
  50. Now type TOSCPM <tosfilename> <cpmfilename>
  51.  
  52. What that means is that you're going to transfer files from your ST formatted
  53. disk to a CP/M formatted disk. If you have 2 drives for example, put your
  54. CP/M disk in A: and your TOS disk with the CP/M files on it into B: then
  55. type (for instance), TOSCPM B:NULU.COM A:NULU.COM
  56.  
  57. This will transfer the program to the CP/M disk (note that you don't have to
  58. type everything in Uppercase... that's just for clarity here).
  59.  
  60. If you have only one drive, type TOSCPM A:NULU.COM A:NULU.COM
  61.  
  62. Unfortunately, this utility does NOT allow you to use 'wildcards' to get it
  63. all over with easily. You have to type the full command and filename set for
  64. EACH file you want to transfer. If you EVER wanted an object lesson on how
  65. much easier GEM is to work with than a 'command line' setup, this is IT!
  66.  
  67. Once you use TOSCPM to transfer all the .COM files to your CP/M disk, you're
  68. ready to use your new CP/M emulator. The only use you'll have now for the
  69. normal ST TOS disk will be to run the CPMZ80.TOS Emulator itself.
  70.  
  71. The other utility that was created by the MAKE_CPM.TOS process way back in
  72. the beginning is INITDSK.COM which is used to convert a new formatted disk
  73. to a CP/M formatted disk. Whenever you need a new disk, format it normally
  74. from GEM (remember, Single Sided only!), then once you are in CP/M, type
  75. at the A: prompt INITDSK and follow the prompts to change disks.
  76.  
  77.  
  78. A few observations...
  79.  
  80. There is an excellent CP/M terminal program available on the CP/M Roundtable
  81. here on GEnie, called MEXST.COM. If you decide to use this, be sure to also
  82. get the MEX.HLP file, and perhaps the MEXCMDS file which will help you get
  83. the most out of the program. This will allow you to download CP/M files and
  84. programs directly to your CP/M formatted disks. However, what might actually
  85. be easier for occasional use, is to download CP/M programs to a normal ST
  86. disk using your regular ST terminal program, then transfer them to the CP/M
  87. disk off-line using the TOSCPM.COM utility, as you did above with the CP/M
  88. utilities.
  89.  
  90. You'll find many of the CP/M files in the GEnie CP/M Roundtable have been
  91. SQUeezed, or LiBRaried, or BOTH... to restore these programs, you'll have to
  92. download copies of LU310.COM and USQ120.COM from the CP/M Roundtable, and
  93. run them under CP/M.
  94.  
  95. (I encountered a 'bug' when running LU310 to 'deLiBRary' some CP/M files, where
  96. when I tried to exit from the program, I got an 'Emulator Error' and was
  97. bounced back to the GEM Desktop. I finally managed to avoid this by OPENING
  98. a new LBR file with 0 sectors. LU doesn't like this, and errors out back to
  99. the A: prompt without crashing to GEM. If you don't understand what that
  100. means, don't worry about it, re-loading CP/M isn't all that bad)
  101.  
  102. One other thing, files with a .ASM (or .AQM for the SQUeezed version) are
  103. the SOURCE CODE files for the Z80 assembler, in case you want to take a look
  104. at how the program works, or want to re-assemble it. Since the Atari CP/M
  105. Emulator doesn't COME with an assembler, you might want to avoid 'deLiBRarying'
  106. these .ASM files and cluttering up your Single Sided disks. DO be sure to
  107. read all the .DOC files though!
  108.  
  109. Unfortunately, MANY, MANY of the programs in the GEnie CP/M Roundtable are
  110. written in Microsoft BASIC (usually called MBASIC in the CP/M RT). Microsoft
  111. BAISC is NOT Public Domain, and right now is NOT available for the ST (as far
  112. as I know, it's not available on a 3 1/2 inch CP/M disk)... SO... unless you
  113. already own a copy of Microsoft BASIC for a different computer, and can somehow
  114. transfer it to an ST CP/M disk, you CAN'T use ANY of these MBASIC programs
  115. that are available!! Don't waste you time downloading them in other words!
  116.  
  117. There ARE a couple of BASICs available in the CP/M RT, but so far, I haven't
  118. had time to work with them and see if they are at all compatible with MBASIC.
  119.  
  120.  
  121.  
  122. This should get you up and running with CP/M on your ST. For help in actually
  123. USING CP/M, be sure to drop into the GEnie CP/M Roundtable. They have an
  124. Atari Category expecially for users of the Atari ST CP/M Emulator, and will
  125. be happy to answer all your questions!
  126.  
  127. If you find any good CP/M programs on local 'RCPM' BBSs, please upload them
  128. to the CP/M RT, as they can be shared by ALL users of CP/M...!
  129.  
  130. Questions about getting the CP/M Emulator running on your Atari ST can of
  131. course be answered on the GEnie ST Roundtable!
  132.  
  133. #############################################################################################